---
sidebar_position: 1
---

import Image from '@theme/IdealImage';

# server.properties

修改服务器的运行配置，以此来定制一些基本功能。

## `server-ip`
| 数据类型   | 默认值     |
|--------|---------|
| String | 0.0.0.0 |

服务器的端口

:::note

同一端口不能运行多个服务器

如果不能访问请检查防火墙

基岩版使用 UDP 协议

:::

## `server-port`
| 数据类型    | 默认值   |
|---------|-------|
| Integer | 19132 |

服务器的端口

:::note

同一端口不能运行多个服务器

如果不能访问请检查防火墙

基岩版使用 UDP

:::

## `enable-query`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用 Query 查询

详见：https://wiki.vg/Query

## `motd`
| 数据类型   | 默认值              |
|--------|------------------|
| String | Minecraft Server |

服务器名称/显示在服务器列表上的文本

:::note

不能为空

:::

## `sub-motd`
| 数据类型   | 默认值                   |
|--------|-----------------------|
| String | Powered by Nukkit-MOT |

motd 的第二行

:::note

只有当在游戏中的好友列表中查看服务器时，才会显示给本地网络中的玩家

自 1.16.210 以来不能为空

:::

## `view-distance`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 8   |

最大视距（以区块为单位）

更大的值 = 加载更多区块 = 更多的内存和 CPU 使用

## `achievements`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用玩家成就

## `announce-player-achievements`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

向所有玩家广播获得成就的消息

## `spawn-protection`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 10  |

非管理员(OP)玩家无法在区块内建造或破坏方块的生成保护区域大小（以方块为单位）

## `max-players`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 50  |

服务器允许的最大玩家人数

## `drop-spawners`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

刷怪笼被挖掘后掉落

## `spawn-animals`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

启用动物生成

## `spawn-mobs`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

启用怪物生成

## `gamemode`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 2   |

服务器的默认游戏模式

0 = 生存, 1 = 创造, 2 = 冒险, 3 = 旁观

## `force-gamemode`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

每次加入时将玩家游戏模式设置为默认游戏模式

## `difficulty`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 2   |

服务器的默认难度（0-3）

## `hardcore`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

玩家死亡后将其封禁

## `pvp`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

是否启用玩家对战

## `white-list`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

仅允许白名单中的玩家加入服务器

使用`/whitelist`命令或修改 `white-list.txt` 来添加玩家到白名单

## `whitelist-reason`
| 数据类型   | 默认值                    |
|--------|------------------------|
| String | Server is white-listed |

启用白名单的原因，显示给被阻挡在外的玩家

## `generator-settings`
| 数据类型   | 默认值 |
|--------|-----|
| String |     |

默认级别的特殊世界生成器设置

## `level-name`
| 数据类型   | 默认值   |
|--------|-------|
| String | world |

默认世界的名称

## `level-seed`
| 数据类型   | 默认值 |
|--------|-----|
| String |     |

默认世界的种子

## `level-type`
| 数据类型   | 默认值  |
|--------|------|
| String | void |

如果默认世界不存在，则使用的生成器

默认支持：default, normal, flat, nether, the_end或void

## `enable-rcon`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

启用远程控制台访问

:::note

RCON 不是一个非常安全的远程控制服务器的方式

RCON 可以使用与服务器相同的端口（TCP 协议）

:::

详见：https://developer.valvesoftware.com/wiki/Source_RCON_Protocol

## `rcon.password`
| 数据类型   | 默认值     |
|--------|---------|
| String | 随机10位字符 |

RCON 连接的密码

## `rcon.port`
| 数据类型    | 默认值   |
|---------|-------|
| Integer | 25575 |

RCON 连接的端口

## `auto-save`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

自动保存世界、玩家数据

:::note

如果禁用，则对世界的更改不会自动保存，即使在卸载时也是如此，如果需要可以使用插件手动保存

:::

您可以使用 `worlds-level-auto-save-disabled` 仅禁用自动保存世界

## `force-resources`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

强制玩家下载服务器的资源包后才能加入

还请参阅 `force-resources-allow-client-packs`

## `force-resources-allow-client-packs`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

在启用 `force-resources` 时不要禁用客户端自己的资源包

## `xbox-auth`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

需要经过 Xbox 帐户验证后才能加入

:::note

不会绕过客户端的限制条件。

如果您选择禁用此功能（不推荐这样做），请在玩家名称和 UUIDs 传递给权限管理器或管理员之后，以确保它们已经得到了验证。

:::

## `encryption`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用网络加密

如果不使用代理软件，则建议启用此功能

## `bed-spawnpoints`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

允许玩家使用床和重生锚设置重生点

## `explosion-break-blocks`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用爆炸对方块造成的破坏

影响所有爆炸，如 TNT、苦力怕和末影水晶

## `stop-in-game`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

允许 OP 在游戏中使用 `/stop` 命令

## `op-in-game`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

允许 OP 在游戏中使用 `/op` 命令对其他玩家进行操作

## `space-name-mode`
| 数据类型   | 默认值    |
|--------|--------|
| String | ignore |

玩家名称中带有空格的处理方式

"disabled" - 禁止带有空格名称的玩家进入服务器

"ignore" - 忽略空格名称 （默认）

"replacing" - 用"_"替换玩家名称中的空格

## `xp-bottles-on-creative`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

允许创造模式下玩家扔经验瓶

## `spawn-eggs`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

启用刷怪蛋，允许通过刷怪蛋生成实体

## `mob-ai`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用 MobPlugin 的生物 AI

## `entity-auto-spawn-task`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

启用自动生成怪物和动物的任务

生成功能依据服务器的游戏难度来工作

注意：如果您希望生成任何生物，必须启用`spawn-animals`、`spawn-mobs`其一，或者两者都启用。

## `entity-despawn-task`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

若启用，则没有使用命名牌命名的生物的会自动消失

:::note

末影龙、凋灵和村民不会消失

:::

## `language`
| 数据类型   | 默认值 |
|--------|-----|
| String | eng |

Nukkit 使用的默认语言

## `force-language`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

强制使用服务器端翻译

只有在你有插件来实现这些翻译时才启用

## `shutdown-message`
| 数据类型   | 默认值           |
|--------|---------------|
| String | Server closed |

当您停止服务器时向玩家显示的消息

可以使用颜色符号`§`，换行请使用 `§n`。

## `save-player-data`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

如果启用，则以其UUID保存玩家数据的格式，并自动将旧格式的玩家数据转换为新格式

如果使用旧版Waterdog代理，请禁用此功能

如果存在新的玩家数据，请勿禁用

## `query-plugins`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

若启用则 Query 查询可以获取插件列表（enable-query=on）

## `debug-level`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 1   |

如果您想要更多的调试日志记录，请设置较高的值（1-3）

## `async-workers`
| 数据类型   | 默认值  |
|--------|------|
| String | auto |

异步工作线程数

如果设置为 auto，则会尝试自动检测核心数进行调整

## `zlib-provider`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 2   |

选择 zlib 提供程序

0 = ZlibOriginal，1 = ZlibSingleThreadLowMem，2 = ZlibThreadLocal

默认：2

其他提供程序可能会对服务器的性能产生负面影响

## `compression-level`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 4   |

发送数据包的 Zlib 压缩级别（0-9）

更高的值 = 更多的 CPU 占用 + 更少的网络占用

## `compression-threshold`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 256 |

不要压缩小于此值的批处理数据包（仅限Zlib）

## `use-snappy-compression`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

使用 Snappy 压缩数据包

## ~~min-mtu~~
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 576 |

~~设置最小 MTU 大小~~

~~默认值：576~~

## ~~max-mtu~~
| 数据类型    | 默认值  |
|---------|------|
| Integer | 1492 |

~~设置最大 MTU 大小（576 - 1492）~~

~~值越大网络发包越高效，但较小的值或许可以解决某些连接上的问题。~~

## `rak-packet-limit`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 120 |

每个ip可以在一个 RakNet 周期（10ms）内发送的数据包数量

超过此限制的ip将被暂时封禁

## `enable-rak-send-cookie`
| Data Type | Default Value |
|-----------|---------------|
| Boolean   | on            |

启用此选项后，服务器会在客户端连接时发送一个 Cookie，用于验证客户端的合法性。

这将增强连接的安全性，防止潜在的恶意连接或攻击。

## `timeout-milliseconds`
| 数据类型    | 默认值   |
|---------|-------|
| Integer | 25000 |

如果客户端没有响应，服务器应该等待多长时间后踢出玩家

单位为毫秒，1000 毫秒 = 1 秒

## `auto-tick-rate`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

允许服务器自动调整世界游戏刻以维持每秒 20 个游戏刻

## `auto-tick-rate-limit`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 20  |

服务器可以临时降低游戏刻速率到多少

## `base-tick-rate`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 1   |

基础游戏刻速率

1 = 每秒 20 个刻度，2 = 每秒 10 个刻度，以此类推。

建议保持默认值（1）。

## `always-tick-players`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

始终对玩家进行游戏刻更新

## `light-updates`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

光照更新

## `clear-chunk-tick-list`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

允许服务器在完成每个游戏刻的逻辑更新后，清空用于追踪哪些区块需要进行逻辑更新的列表 `chunkTickList`。

这可以帮助优化服务器性能，防止不必要的计算，特别是在大型服务器或有大量区块需要管理的情况下。

## `spawn-threshold`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 56  |

在生成玩家之前需要加载多少个区块

## `chunk-sending-per-tick`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 4   |

每游戏刻发送的区块数

## `chunk-ticking-per-tick`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 40  |

每游戏刻 `chunkTickList` 存储的区块数

## `chunk-ticking-radius`
| Data Type | Default Value |
|-----------|---------------|
| Integer   | 3             |

玩家周围需要进行刻算的区块半径

## `chunk-generation-queue-size`
| Data Type | Default Value |
|-----------|---------------|
| Integer   | 8             |

等待生成的区块数量

## `chunk-generation-population-queue-size`
| Data Type | Default Value |
|-----------|---------------|
| Integer   | 8             |

等待填充的区块数量

## `ticks-per-autosave`
| Data Type | Default Value |
|-----------|---------------|
| Integer   | 6000          |

世界自动保存任务运行的频率

以刻为单位，20刻 = 1秒

## `ticks-per-entity-spawns`
| Data Type | Default Value |
|-----------|---------------|
| Integer   | 200           |

实体自动生成任务运行的频率

以刻为单位，20刻 = 1秒

## `ticks-per-entity-despawns`
| Data Type | Default Value |
|-----------|---------------|
| Integer   | 12000         |

实体存活的时间

以刻为单位，20刻 = 1秒

## `thread-watchdog`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用线程看门狗

## `thread-watchdog-tick`
| 数据类型    | 默认值   |
|---------|-------|
| Integer | 60000 |

如果 Nukkit-MOT 主线程暂停超过 60000 毫秒，会抛出致命错误并终止执行的毫秒数

## `nether`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

生成地狱世界

## `end`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

生成末地世界

## `vanilla-portals`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

原版传送门

## `portal-ticks`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 80  |

玩家触发传送门所需Tick

## `multi-nether-worlds`
| 数据类型   | 默认值 |
|--------|-----|
| String |     |

如果你需要多个地狱世界，在这里列出应该有自己地狱的世界，否则使用默认的地狱世界

## `anti-xray-worlds`
| 数据类型   | 默认值 |
|--------|-----|
| String |     |

启用内置反矿透的世界列表

示例：`world, survival, factions`

## `do-not-tick-worlds`
| 数据类型   | 默认值 |
|--------|-----|
| String |     |

禁用随机方块刻度的世界列表

这将禁用植物生长、树叶腐烂、草方块蔓延、方块掉落等。

你可能想在这里添加你的大堂和迷你游戏世界

## `worlds-entity-spawning-disabled`
| 数据类型   | 默认值 |
|--------|-----|
| String |     |

不允许实体自动生成的世界列表

示例：`lobby, pvp, creative`

## `load-all-worlds`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

加载所有世界

## `ansi-title`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

启用在 Windows CMD 标题中显示服务器占用信息

<Image img={require('@site/static/images/server-config/windows_cmd_title.png')} alt="Windows 命令行标题" />

## `block-listener`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用用于雪块、铁傀儡、怪物蛋石等的检查

## `allow-flight`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

启用/禁用飞行反作弊

## `multiversion-min-protocol`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 0   |

多版本的最低协议

## `multiversion-max-protocol`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | -1  |

多版本的最高协议

## `vanilla-bossbars`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

显示凋零和末影龙的Boss血条（实验性）

## `strong-ip-bans`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

强制 IP 封禁

## `worlds-level-auto-save-disabled`
| 数据类型   | 默认值 |
|--------|-----|
| String |     |

禁用自动保存

等级的世界

## `temp-ip-ban-failed-xbox-auth`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

临时封禁 Xbox 身份验证失败的玩家

## `call-data-pk-send-event`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

如果没有插件使用它，可以禁用 `DataPacketSendEvent` 以获得更好的性能

## `call-batch-pk-send-event`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

如果没有插件使用它，可以禁用 `BatchPacketsEvent` 以获得更好的性能

## `do-level-gc`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

在游戏刻之间进行世界垃圾收集

## `skin-change-cooldown`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 15  |

玩家皮肤更换冷却时间（秒）

## ~~check-op-movement~~
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

~~为管理员(OP)启用移动检查~~

## `do-not-limit-interactions`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

禁用用于限制客户端右键交互垃圾数据包的黑客技术

## `do-not-limit-skin-geometry`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

禁用最大皮肤几何大小检查

可能对某些玩家，皮肤的可用性是必需的

## `automatic-bug-report`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用自动报告错误

## ~~anvils-enabled~~
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

~~启用铁砧~~

~~在 Nukkit 上，铁砧属于实验性功能方块，普遍存在物品重命名、物品数据丢失等问题~~

## `save-player-data-by-uuid`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

如果启用，则以 NukkitX 使用的格式保存玩家数据，并自动将旧格式的玩家数据转换为新格式

如果使用旧版 WaterdogPE 代理，请禁用此功能

:::note

如果存在新的玩家数据，请勿禁用

:::

## `persona-skins`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

允许玩家自己的皮肤

:::note

如果禁用，将显示默认的史蒂夫皮肤

某些玩家的皮肤可能需要启用 `do-not-limit-skin-geometry` 才能使用

:::

## ~~call-entity-motion-event~~
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

~~您可以禁用 EntityMotionEvent 以获得更好的性能，如果您的插件没有使用它~~

## `update-notifications`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

有新的 Nukkit-MOT 版本发布时通知刚加入游戏的管理员(OP)

## `bstats-metrics`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用 bStats 统计

https://bstats.org/plugin/server-implementation/Nukkit/

匿名收集数据：Nukkit 版本（Nukkit-MOT）、玩家数量、玩家游戏版本、是否开启 Xbox 身份验证、Java 版本、操作系统、CPU 架构及数量、服务器地理位置（粗略）

## `cache-chunks`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

将区块保存到内存中以加快发送速度

:::note

多版本支持的效果不佳

:::

## `async-chunks`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用异步区块发送

当向不同版本的玩家发送大量区块时，这可以极大地提高性能

建议保持此选项开启

## `deprecated-verbose`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

当插件使用不推荐 API 时在控制台显示警告。

## `server-authoritative-movement`
| 数据类型   | 默认值         |
|--------|-------------|
| String | server-auth |

服务器移动验证方式
可选：`client-auth / server-auth-with-rewind / server-auth`

## `server-authoritative-block-breaking`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

服务器权威方块破坏

## `use-client-spectator`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

使用客户端侧的旁观者模式

## `enable-experiment-mode`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用实验模式

## `use-waterdog`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

尝试获取 WaterdogPE 提供的客户端真实 IP

详见：https://waterdog.dev/

## `enable-spark`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

启用 Spark 用于性能分析

详见：https://spark.lucko.me/docs

## `hastebin-token`
| 数据类型   | 默认值 |
|--------|-----|
| String |     |

Hastebin 令牌，方便生成 debug 链接

详见：https://www.toptal.com/developers/hastebin/documentation

## `use-native-leveldb`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | off |

使用原生的 LevelDB 实现

## `enable-raw-ores`
| 数据类型    | 默认值 |
|---------|-----|
| Boolean | on  |

启用粗矿石；若启用则对高版本玩家掉落粗铜、粗铁、粗金

版本自 [BE 1.17.0](https://minecraft.wiki/w/Bedrock_Edition_1.17.0) 起

## `enable-new-paintings`
| Data Type | Default Value |
|-----------|---------------|
| Boolean   | on            |

启用在1.21版本新加入的画

## `enable-new-chicken-eggs-laying`
| Data Type | Default Value |
|-----------|---------------|
| Boolean   | on            |

启用鸡产出新类型鸡蛋
（蓝色鸡蛋&棕色鸡蛋）

## `leveldb-cache-mb`
| 数据类型    | 默认值 |
|---------|-----|
| Integer | 80  |

与 `use-native-leveldb` 一同使用

用于减少每个世界硬盘读写操作的区块数据最大缓存大小

如果你拥有大量内存并且仅有几个大型世界，可以调高此缓存大小

## `forced-safety-enchant`
| Data Type | Default Value |
|-----------|---------------|
| Boolean   | on            |

启用强制安全附魔（限制附魔最大等级）